home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / olrdrs / kqwk105.zip / KINGQWK.DOC < prev    next >
Text File  |  1992-04-05  |  45KB  |  1,058 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                                   KingQWK
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                         The KingQWK QWK Mail Reader
  21.  
  22.                     QWK message packet reading program.
  23.  
  24.                       Copyright (c) 1991-92 Mike King
  25.                             All Rights Reserved.
  26.  
  27.                     Version 1.05            April 1992
  28.  
  29.  
  30.  
  31.  
  32.         Licensed Material.  Unauthorized distribution is prohibited.
  33.            (c) Copyright  Mike King 1991-92.  All rights reserved
  34.  
  35.  
  36.  
  37.  
  38.  
  39. Copyright, License and Warranty
  40. __________________________________________________________________________
  41.  
  42.     KingQWK is a copyrighted, user-supported program.  It is not in the
  43.     public domain.
  44.  
  45.     Individuals may use and distribute KingQWK according to the restrictions
  46.     detailed below.  You may use the program and give it to your friends, but
  47.     it may not be sold nor used in a business or otherwise used for profit
  48.     without obtaining a license.  See the last page for information about
  49.     licensing.
  50.  
  51.     KingQWK is not copy-protected.  It may be copied and distributed to
  52.     others providing that it is supplied in its original, unregistered and
  53.     unmodified form, including this documentation.  The keyfile which is used
  54.     to register KingQWK is not to be copied nor distributed.  No fee may be
  55.     charged for copying and distribution of the KingQWK program other than a
  56.     minimal fee covering the cost of the copying medium.
  57.  
  58.     Any alterations of the code are expressly prohibited.  No one may modify
  59.     the KingQWK programs or related materials for any reason, in any way,
  60.     including decompiling, disassembling, reverse engineering, or copying,
  61.     except as stated herein.
  62.  
  63.     No warranty, either expressed or implied, is granted regarding the
  64.     programs and related materials, their fitness, their quality, or
  65.     otherwise.  The copyright owner shall not be held liable for any damages,
  66.     including any lost profits or other incidental, consequential or special
  67.     damages arising out of use of or inability to use the software.  By using
  68.     the software, you agree to this.
  69.  
  70.     The copyright owner reserves the right to make any changes to these
  71.     programs, related materials, or documentation at any time without prior
  72.     notice.
  73.  
  74.     
  75.     Note:  KingQWK and KingCfg are trademarks owned by Mike King.
  76.  
  77.  
  78.            Any other brand or product names mentioned in this
  79.            documentation are trademarks or registered trademarks of
  80.            their respective companies.
  81.  
  82.  
  83.  
  84.  
  85.  
  86. Getting Started
  87. ______________________________________________________________________________
  88.  
  89. Introduction
  90.  
  91.    
  92.     KingQWK is registered via a keyfile available on IDC BBS within 10
  93.     days after receipt of a personal or company check or 24 hours after
  94.     receipt of a cashier's check or money order.  You may reach IDC BBS
  95.     at 415-865-7115. Complete registration instructions and a mail-in
  96.     order form are in the file REGISTER.FRM.
  97.     
  98.     The following is formatted for use in file directory listings when
  99.     uploading KingQWK to a BBS:
  100.  
  101.         KingQWK - The first non-beta release of
  102.         this new FAST, small QWK reader. It has
  103.         MANY features not found in other readers
  104.         including a unique interface to QWKMerge
  105.         allowing it to control precisely which
  106.         messages are merged into the ensuing QWK
  107.         packet.     Shareware by Mike King
  108.  
  109.     Shareware by Mike King.
  110.  
  111.  
  112.  
  113. Getting Started
  114. ______________________________________________________________________________
  115.  
  116. Overview of KingQWK
  117.  
  118.     KingQWK is an offline reader, designed for unpacking, reading, and
  119.     processing packets of messages - primarily from BBS's, in QWK
  120.     format. It provides various sorting and edit/interfacing functions.
  121.  
  122.     Extensive on-line help is available in both KingCfg and KingQWK.  To
  123.     obtain help at any time, press [F1].  To leave help, press [Esc].
  124.  
  125.     You may also customize the KingQWK colors.  The information about
  126.     paths and colors is stored in a new file, KINGQWK.CTL, which is
  127.     created by KingCfg and placed into the current directory.
  128.  
  129.     KingQWK is small and compact freeing up valuable memory for
  130.     TSR's, sorting conferences with large numbers of messages and
  131.     floppy based systems.
  132.  
  133.     KingQWK is exceptionally fast!
  134.  
  135.     Designed primarily but not exclusively to work in concert with
  136.     QWKMerge to make a complete QWK Mail Manangement system.
  137.  
  138.     ANSI support is available with the touch of a key with a
  139.     continuous flow display so annoying "MORE?" prompts don't disrupt
  140.     the ANSI graphics. The speed of this scolling is configurable.
  141.     Additionally the editor, text viewer, and ANSI viewer can all be
  142.     configured to external programs.  KingQWK uses *YOUR* ANSI driver
  143.     for ANSI display!  No more ANSI conflicts!  No extra memory
  144.     wasted!
  145.  
  146.     Delete or Rename QWK packets from the packet selection screen.
  147.  
  148.     KingQWK has the capability of a "TWIT" file to exclude
  149.     messages either from configured users or those with defined
  150.     strings in the subject field.
  151.  
  152.     KingQWK also has a unique "Magnet" file which is the reverse of
  153.     the "TWIT" file. Here user's messages or subject text strings can
  154.     be defined so that ONLY these messages are read.
  155.  
  156.     FIDO compliance toggle to use only standard ASCII in QUOTING
  157.     and Taglines with no tear bars.
  158.  
  159.     Full Tagline support for multiple tagline files.  Taglines may be
  160.     up to 75 characters long.
  161.  
  162.     DESQview aware
  163.  
  164.     Support for remote QWK mail door configuration including QMAIL4,
  165.     MarkMail, and Tomcat!
  166.  
  167.     Mouse support is available for rat fans.
  168.  
  169.     25/43/50 line video support
  170.  
  171.     KingQWK has the ability to swap-out to XMS, EMS or DISK during
  172.     DOS shells leaving a mere 1.8k still in memory.
  173.  
  174.     Read flags and bookmarks are fully supported and configurable for
  175.     those who like to only read part of a mail packet at a time.
  176.  
  177.     Configurable personal message bell.
  178.  
  179.     Message indexing and sorting by message number, date, subject,
  180.     source, or recipient.
  181.  
  182.     Print and Save messages individually, or all messages: in the
  183.     current conference, containing a keyword or phrase in the
  184.     subject, from a user or to a user.
  185.  
  186.     New files, bulletins, and News viewing in full ANSI.
  187.  
  188.     Complete archiver configuration
  189.  
  190.     KingQWK is capable of handling up to 10,000 messages PER
  191.     CONFERENCE and over 32,000 conferences.  This allows reading of
  192.     very large archived mail packets created with QWKMerge which
  193.     allows you to store BBS mail into packets as large as you have
  194.     disk space to accomodate.
  195.  
  196.     KingQWK allows for trimming of QWK packets by deleting
  197.     specific messages saving only the messages you want. If you make
  198.     a mistake you can unkill a message before you merge the QWK
  199.     packet.
  200.  
  201.     Kill and UnKill messages individually, or all messages: in the
  202.     current QWK packet, in the current conference, containing a
  203.     keyword or phrase in the subject, from a user or to a user.
  204.  
  205. Note:  The QWKMerge utility performs the actual killing of flagged
  206.        messages during the merge process.
  207.  
  208.     Enjoy the program!
  209.  
  210.  
  211.  
  212.  
  213.  
  214. Installation
  215.  
  216.     To install KingQWK, unZIP the .ZIP file into a directory in your DOS
  217.     path.  Your reader directory may be used or you may put KingQWK
  218.     into a directory of its own.
  219.  
  220.     If you want to run KingQWK from a directory that is neither the current
  221.     directory nor on the DOS path, you can use the "SET QWKMDIR=" DOS command
  222.     to tell the program where to look for its help and configuration files.
  223.     i.e. SET KQWKDIR=C:\KINGQWK.  You may type this at the DOS prompt to set
  224.     the environment variable, or use it in a BATch file.
  225.  
  226.     Two of the programs in the .ZIP file are necessary for operation.  These
  227.     two files are KINGQWK.EXE and KINGCFG.EXE.  See "Overview of KingQWK"
  228.     for the functions of each of these programs.  A third necessary file,
  229.     KINGQWK.CTL, will be created by KINGCfg in the cu